home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / dcom20.zip / DCOM.DOC < prev    next >
Text File  |  1991-08-25  |  6KB  |  189 lines
  1. DCOM V2.0 Serial Data Analyzer                                        Page 1 
  2.  
  3.  
  4. DCOM is a simple but useful datacom capture program that runs on a PC or
  5. AT compatable machine.  Two serial ports are required.  Data is captured
  6. as it flows in from both ports  The data is then directed out to the opposite
  7. port that it was received from.  Although no additional hardware is required, 
  8. additional serial cables to connect to the PC are required.
  9.  
  10.  
  11.     This program is being distributed as Shareware.
  12.     If this program is of any use to you then you should
  13.     register your copy by sending $35.00 (US) to the author.
  14.     With registration the latest version and documentation of the program
  15.     (without the starup screen) will be sent along with some additional
  16.     features (Macro keys and some basic ANSI terminal emulation).
  17.     Send all registrations to:
  18.  
  19.  
  20.             Jim Davis    (CID 76535,2156)
  21.  
  22.             1074 Hetrick Avenue
  23.  
  24.             Arroyo Grande, CA  93420
  25.  
  26.  
  27.     Make check payable to Jim Davis.
  28.  
  29.  
  30. Assume the following duplex connection between device 1 and 2 (figure 1).
  31. Data is flowing between the two devices.  There may be some problem, but 
  32. there isn't an easy way to tell whats wrong without interrupting the
  33. connection and stopping the protocol.
  34.  
  35.  
  36.  
  37.       /----------\                          /----------\
  38.       |          |                          |          |
  39.       | Device 1 |                          | Device 2 |
  40.       |          |                          |          |
  41.       \----------/                          \----------/
  42.           \                                      /
  43.            \                                    /
  44.             \    Data [x]->                    /
  45.              ----------------------------------             
  46.                         <-Data [y]
  47.  
  48.  
  49.                         (figure 1)
  50.  
  51. DCOM V2.0 Serial Data Analyzer                                        Page 2
  52.  
  53.  
  54. With DCOM running on the PC (figure 2), the data will be captured, 
  55. displayed, and then sent to the remote device (in both directions).
  56. The serial data can be examined as it happens, or viewed later from the
  57. captured data buffer or saved to disk and printed.
  58.  
  59.  
  60.  
  61.       /----------\         /----\       /----------\
  62.       |          |         |Data|       |          |
  63.       | Device 1 |         |xy  |       | Device 2 |
  64.       |          |         |    |       |          |
  65.       \----------/         \----/       \----------/
  66.           \              |---------|             /
  67.            \             | PC DCOM |            /
  68.             \ Data [x]-> |---------|           /
  69.              --------------Port 1             /  
  70.                            Port 2-------------             
  71.                        <-Data [y]
  72.                            
  73.                         (figure 2)
  74.  
  75.                       
  76.                         
  77. DCOM supports data rates of 300, 600, 1200, 2400, 4800, 9600, 19200, 38400,
  78. 57600, and 115200 bps.  Note: When running full duplex, a 4MHz PC can keep
  79. up with data at about 1200 bps.  On a 12 MHz AT at full duplex rates of
  80. 9600 bps can be supported.  If an overrun occurs, a message is printed to
  81. that effect.
  82.  
  83. DCOM displays the data from each port in different colors so that it can
  84. be easily examined.  The baud rate and color for each of the ports are
  85. in the DCOM.CFG file.  The colors cannot be changed once the program
  86. starts.
  87.  
  88. DCOM accepts command line parameters to change the baud rate and 
  89. port colors.  The command line parameters will change the contents of
  90. the DCOM.CFG file.  The command line is as follows:
  91.  
  92.  
  93.     DCOM  [baud_rate  color1  color2]
  94.  
  95.     where baud_rate is 300, 600, 1200, 2400, 4800, 9600, ...
  96.               color1 is 0, 1, 2, 3, 4, 5, 6, .. 15 
  97.               color2 is 0, 1, 2, 3, 4, 5, 6, .. 15  (can't be same!)
  98.  
  99.                         
  100. DCOM V2.0 Serial Data Analyzer                                        Page 3
  101.  
  102. Help Screen
  103.  
  104. A simple help screen is available when online by pressing the F1 key.
  105. Here is a brief explaination of what the options are.
  106.  
  107.  
  108. Display Commands
  109. ----------------
  110.  
  111. [+] and [-]
  112.  
  113. The display commands are used to turn on and off the output to the screen
  114. as the characters are received at the data ports.  Turn the display off
  115. when it is not necessary to view characters.  
  116.  
  117. [A]scii Toggle
  118.  
  119. The display mode can be toggled between ASCII and HEX.  In HEX mode the
  120. ASCII equivalent is shown on the right side of the screen.
  121.  
  122. [ESC]
  123.  
  124. The escape key will clear the screen.
  125.  
  126.  
  127.  
  128. System Commands
  129. ---------------
  130.  
  131. [1] and [2]
  132.  
  133. The system commands [1] and [2] open the com ports (1 & 2) for sending data
  134. from the keyboard.  All keys entered on the keyboard are sent to the open
  135. port except the F10 key which is the only way to CLOSE the port and return to
  136. the program.
  137.  
  138. [F2]
  139.  
  140. The baud rate can be changed once the program is started.  Note that changing
  141. the baud rate amid communications may generate some really wierd characters.
  142.  
  143. [F10]
  144.  
  145. To exit the program the F10 key is pressed and then confirmed.
  146.  
  147.  
  148. DCOM V2.0 Serial Data Analyzer                                        Page 4
  149.  
  150. Buffer Commands
  151. ---------------
  152.  
  153. The data buffer will hold up to 16384 characters.  Any bytes sent beyond this
  154. limit will be lost although they are still displayed to the screen.  The
  155. buffer commands are used to navigate through the buffer from top to bottom
  156. and to save the buffer to disk.
  157.  
  158.  
  159. [HOME], [END]
  160.  
  161. Move the pointer to the beginning (or end) of the buffer and display the next
  162. (or last) 256 characters.
  163.  
  164. [PG UP], [PG DWN]
  165.  
  166. Move the pointer 256 bytes up or down in the the buffer and display the next
  167. 256 characters.
  168.  
  169. [DEL]
  170.  
  171. The delete key is used to delete the contents of the buffer and start over.
  172.  
  173.  
  174. Cursor Up  [],  Cursor Down  []
  175.  
  176. Move the pointer 16 bytes up or down in the the buffer and display the next
  177. 256 characters.
  178.  
  179.  
  180. [S]ave
  181.  
  182. Save the entire buffer to the disk file DCOM.BUF.  Successive saves will
  183. append the buffer to the end of the DCOM.BUF file  (The first save will
  184. clear out the old file contents.)
  185.  
  186.  
  187. Happy Data Comm Analysis.  Please send all inquiries and or suggestions
  188. to the address noted above.
  189.